ao

内置全局库，用于发送消息、创建进程等。

示例

全局对象 ao 在你的进程中的任何地方都可以访问：

-- sends a message to another process ("Transfer" action)
ao.send({
  Target = "usjm4PCxUd5mtaon7zc97-dt-3qf67yPyqgzLnLqk5A",
  Action = "Transfer",
  Recipient = "XjvCPN31XCLPkBo9bUeB7vAK0VC6-eY52-CS-6Iho8F",
  Quantity = tostring(1045)
})

模块变量

• ao.id: {string} 保存你进程中的 Arweave ID
• ao.authorities: {table} 授权的调用者数组
• ao._module: {string} 进程的 WASM 基础模块，每次调用都会执行。
• ao._ref: {number} 消息计数器，记录发出消息的总数。
• ao._version: {string} ao global 库版本。
• ao.env: {table} 进程初始化环境信息。

ao.env

全局变量ao.env保存了有关进程初始化消息的信息。它遵循以下结构:

{
  "type": "object",
  "properties": {
    "Process": {
      "type": "object",
      "properties": {
        "Id": {
          "type": "string",
          "example": "A1b2C3d4E5f6G7h8I9j0K1L2M3N4O5P6Q7R8S9T0"
        },
        "Owner": {
          "type": "string",
          "example": "Xy9PqW3vR5sT8uB1nM6dK0gF2hL4jC7iE9rV3wX5"
        },
        "TagArray": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "example": "App-Name"
              },
              "value": {
                "type": "string",
                "example": "aos"
              }
            }
          },
          "example": [{ "name": "App-Name", "value": "aos" }]
        },
        "Tags": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "patternProperties": {
            "": {
              "type": "string"
            }
          },
          "example": {
            "App-Name": "aos"
          }
        }
      }
    }
  }
}

模块函数

log()

log 将值或消息添加到 Results.Output 表中，后面可以使用 aoconnect 库进行读取，对于调试很有帮助。

• Parameters:
  • txt: {any} log 的值/消息内容
• Returns: {void}

Examples

...
ao.log("Breakpoint reached")
...
ao.log({
  Message = "Transferred " .. quantity .. " tokens to " .. target,
  Quantity = quantity,
  Recipient = target
})

send()

向另一个进程发送消息。将消息放入进程的 outbox，并根据 AO 标准(ao specs compliant ) 标注消息的 tag

• Parameters:
  • msg: {table} 待发送的消息
• Returns: 已发送的消息，包含已应用的标签和DataItem字段。

Note: msg 表的每个字段都会作为 DataItem 标签，但以下字段除外："Target", "Data", "Anchor", "Tags"，因为这些字段将直接作为根级别的DataItem字段使用。

Example

-- sends a message to "XjvCPN31XCLPkBo9bUeB7vAK0VC6-eY52-CS-6Iho8F"
-- with the tag { "name": "Action", "value": "Ping" }
ao.send({
  Target = "XjvCPN31XCLPkBo9bUeB7vAK0VC6-eY52-CS-6Iho8F",
  Action = "Ping"
})

spawn()

创建新进程。

• Parameters:
  • module: {string} 新进程使用的模块的 Arweave 交易 ID
  • msg: {table} 初始化进程的消息，格式在上面send部分中
• Returns: 初始化的消息

Example

ao.spawn("n0BFH80b73mi9VAWUzyuG9gEC3LI2zU2BFxum0N8A9s", {
  ["Custom-Tag"]: "Custom-Value"
})